<HTML><HEAD><TITLE>cursor_close(++Cursor)</TITLE>
</HEAD><BODY>[ <A HREF="index.html">library(dbi)</A> | <A HREF="../../index.html">Reference Manual</A> | <A HREF="../../fullindex.html">Alphabetic Index</A> ]
<H1>cursor_close(++Cursor)</H1>
Close the cursor associated with Cursor
<DL>
<DT><EM>Cursor</EM></DT>
<DD>A cursor handle
</DD>
</DL>
<H2>Description</H2>
<P>
 Closes a cursor explicitly, and frees the resources associated with the
 cursor. It takes effect immediately.
</P><P>
 It is recommended that the user close all cursors before explicitly
 closing a session. Cursors that remain open after a session is closed
 cannot be used, but may still be using resources.
</P><P>
 Cursors are automatically closed if the program backtracks or aborts back
 beyond where they were created.

<H3>Exceptions</H3>
<DL>
<DT><EM>(5) type error </EM>
<DD>Cursor is not a cursor handle.
</DL>
<H2>See Also</H2>
<A HREF="../../lib/dbi/session_close-1.html">session_close / 1</A>, <A HREF="../../lib/dbi/session_sql_prepare-4.html">session_sql_prepare / 4</A>, <A HREF="../../lib/dbi/session_sql_query-4.html">session_sql_query / 4</A>, <A HREF="../../lib/dbi/session_sql_prepare_query-5.html">session_sql_prepare_query / 5</A>
</BODY></HTML>
